ARIA: aria-activedescendant-Attribut
Das aria-activedescendant
-Attribut identifiziert das aktuell aktive Element, wenn der Fokus auf einem composite
Widget, einer combobox
, einer textbox
, einer group
oder einer application
liegt.
Beschreibung
Die aria-activedescendant
-Eigenschaft bietet eine Methode zur Verwaltung des Fokus für unterstützende Technologien bei interaktiven Elementen, die mehrere fokussierbare Nachfahren enthalten, wie Menüs, Raster oder Werkzeugleisten. Anstatt den Fokus des Screenreaders zwischen den zugehörigen Elementen zu verschieben, kann aria-activedescendant
bei Container-Elementen verwendet werden, um auf das aktuell aktive Element zu verweisen und den Benutzern unterstützender Technologien mitzuteilen, welches Element aktuell aktiv ist, wenn darauf fokussiert wird.
Mit aria-activedescendant
behält der Browser den DOM-Fokus auf dem Container-Element oder auf einem Eingabeelement, das das Container-Element steuert. Der Benutzeragent kommuniziert Desktop-Fokusereignisse und -zustände an die unterstützende Technologie, als ob das durch aria-activedescendant
referenzierte Element Fokus hätte.
Dieses Attribut ist nur bei Elementen mit der Rolle von composite
Widgets, combobox
, textbox
, group
oder application
relevant, deren id
als Attributwert referenziert wird.
Das Attribut sorgt dafür, assistiven Technologien Informationen darüber zu geben, welches Element den Fokus hat, erzeugt jedoch selbst keinen Fokus. Das Ändern des Fokus und die Verwaltung des Attributwertes erfolgt mit JavaScript. Neben der Verwaltung dieses Attributwertes sollten Sie sicherstellen, dass das aktuell aktive Nachfahrenelement sichtbar ist und im Sichtbereich ist (oder in den Sichtbereich scrollt), wenn darauf fokussiert wird.
Beim Setzen des Wertes von aria-activedescendant
auf ein Element mit DOM-Fokus muss sichergestellt werden, dass der Wert auf ein zugehöriges Element verweist — entweder ein Nachfahre des Elements mit DOM-Fokus ODER ein logischer Nachfahre, wie durch das Attribut aria-owns
angezeigt.
Wenn das Element mit DOM-Fokus eine Combobox, Textbox oder Suchbox ist, sollte aria-controls
hinzugefügt werden, um auf das Element zu verweisen, das aria-activedescendant
unterstützt.
Der Wert von aria-activedescendant
verweist auf ein zugehöriges Element des kontrollierten Elements. Zum Beispiel kann bei einer Combobox der Fokus auf der Combobox bleiben, während der Wert von aria-activedescendant
auf dem Combobox-Element auf einen Nachfahren einer Popup-Liste verweist, die von der Combobox gesteuert wird.
Hinweis:
Das Attribut wird nur für wenige Rollen unterstützt. Zum Beispiel unterstützen dialog
s aria-activedescendant
nicht. Wenn eine Combobox einen Dialog öffnet, bewegt sich der DOM-Fokus vom Combobox in den Dialog, da er mit diesem Attribut nicht referenziert werden kann.
Hinweis:
Wenn ein Nachfahre eines listbox
-, grid
- oder tree
-Popups fokussiert ist, bleibt der DOM-Fokus auf der Combobox und die Combobox hat aria-activedescendant
mit einem Wert gesetzt, der auf das fokussierte Element im Popup verweist.
Werte
- ID-Referenz
-
Nimmt als Wert die
id
des aktuell fokussierten Elements.
Zugehörige Schnittstellen
Element.ariaActiveDescendantElement
-
Die
ariaActiveDescendantElement
-Eigenschaft ist Teil der Schnittstelle jedes Elements. Ihr Wert ist eine Instanz einer Unterklasse vonElement
, die dieid
-Referenz imaria-activedescendant
-Attribut widerspiegelt (mit einigen Einschränkungen). ElementInternals.ariaActiveDescendantElement
-
Die
ariaActiveDescendantElement
-Eigenschaft ist Teil der Schnittstelle jedes benutzerdefinierten Elements. Ihr Wert ist eine Instanz einer Unterklasse vonElement
, die dieid
-Referenz imaria-activedescendant
-Attribut widerspiegelt (mit einigen Einschränkungen).
Zugehörige Rollen
Relevant nur als Attribut bei Elementen mit den folgenden Rollen:
Spezifikationen
Specification |
---|
Accessible Rich Internet Applications (WAI-ARIA) # aria-activedescendant |
Accessible Rich Internet Applications (WAI-ARIA) # aria-activedescendant |